home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d27 / inter490.arc / INTPRINT.DOC < prev    next >
Text File  |  1990-08-04  |  6KB  |  127 lines
  1.                 INTPRINT v1.30
  2.                             by Ralf Brown
  3.  
  4. The INTPRINT program is
  5.     (c) Copyright 1989, 1990 Ralf Brown.  All Rights Reserved.
  6. INTPRINT, its source code, and this documentation may be freely
  7. redistributed, but may not be included as part of any work other than
  8. the interrupt list maintained by Ralf Brown.  If any changes are made to
  9. the program or its documentation, the original version must be included
  10. with the modified version.
  11.  
  12. ------------------------------------------------------------------------------
  13.  
  14. INTPRINT.COM is a VERY simple formatter for the interrupt list.  Use
  15. this program to prevent widow at the beginning of a function call,
  16. number the pages, center the printout in elite (12 cps) mode, or create
  17. a summary of the function calls.  After formatting is complete, the
  18. total number of pages is displayed on the screen.
  19.  
  20. Usage:
  21.    intprint [options] [lines_per_page [page_length]] <interrup.lst [>outfile]
  22.  
  23. where the options are:
  24.     -b    boldface the title lines, Return:, and Notes:
  25.  
  26.         -p    print the page number at the bottom center of each page
  27.  
  28.         -iN   indent the output N spaces.  The output device is assumed to be
  29.               at least 80+N characters wide.
  30.               NOTE: you must put the number immediately after the 'i', no
  31.               blanks are allowed.
  32.  
  33.         -e    assume printer is in elite mode (96 characters per line), and
  34.               indent the output eight spaces to center the printout.
  35.  
  36.         -E    assume the printer is an Epson FX80 or compatible, and send
  37.               control sequences to place the printer in elite mode and center
  38.               the printout.  This option overrides -e and forces -i8
  39.  
  40.         -I    assume the printer is capable of producing IBM character graphics
  41.  
  42.         -nN   assume N pages have already been printed, and start numbering
  43.               at N+1.  This option allows you to create a properly-numbered
  44.               printout even if there is not enough disk space to concatenate
  45.               the parts of the interrupt list.  See the examples below.
  46.               NOTE: you must put the number immediately after the 'n', no
  47.               blanks are allowed.
  48.  
  49.     -rN:M print only pages N through M.  The entire input is processed
  50.           for use in -s and -f summaries (see below) even though only
  51.           a portion is formatted for printing.
  52.           NOTE: you must put the page numbers immediately after the 'r',
  53.           no blanks are allowed.
  54.  
  55.         -sfile  create a one-line-per-function summary and write it to "file"
  56.               if -n is also given, the summary will be appended to "file",
  57.               allowing a properly numbered summary file to be created even if
  58.               there is not enough disk space to concatenate the parts of the
  59.               list.  See the examples below.
  60.               NOTE: you must put the filename immediately after the 's', no
  61.               blanks are allowed.
  62.  
  63.         -ffile  create a file containing only the data structures described
  64.               in the interrupt list.
  65.               NOTE: you must put the filename immediately after the 'f', no
  66.               blanks are allowed.
  67.  
  68. Options may not be combined; "-ep" is illegal and the "p" will be ignored.
  69.  
  70. Lines_per_page specifies how many lines to print on each page (including the
  71. optional page number), and defaults to 60.
  72.  
  73. Page_length specifies how many lines are on a printed page.  If this value is
  74. omitted, a form feed is used to skip to the next page.  If specified, line
  75. feeds are used to skip to the next page.
  76.  
  77. The file to be formatted is read from standard input, and the formatted result
  78. is sent to standard output.  Both may be redirected using the standard Unix or
  79. MSDOS redirection characters < and >.  If you only want a summary file or
  80. data formats file, redirect the output to the null device ("NUL" under MSDOS,
  81. "/dev/null" under Unix).
  82.  
  83. ------------------------------------------------------------------------------
  84.  
  85. EXAMPLES:
  86. ---------
  87.  
  88.         Print the interrupt list with page numbers, and create a summary file,
  89.     without concatenating INTERRUP.A, INTERRUP.B, and INTERRUP.C:
  90.  
  91.                 A> intprint -sb:interrup.sum -p <interrup.a >prn
  92.         116 pages.   [screen output from INTPRINT]
  93.         A> intprint -sb:interrup.sum -p -n116 <interrup.b >prn
  94.         261 pages.   [screen output from INTPRINT]
  95.         A> intprint -sb:interrup.sum -p -n261 <interrup.c >prn
  96.         386 pages.   [screen output from INTPRINT]
  97.  
  98.         Create only a summary file:
  99.  
  100.                 C> intprint -sinterrupt.sum <interrup.lst >nul
  101.  
  102.         Print the interrupt list on an Epson FX80, using 54 lines per page and
  103.         omitting both page numbers and summary:
  104.  
  105.                 C> intprint -E 54 <interrup.lst >prn
  106.  
  107.     Print the interrupt list using 120 lines on every 132-line page (using
  108.     superscript mode, for example), and make divider lines using IBM
  109.     character graphics:
  110.  
  111.                 C> intprint -I 120 132 <interrup.lst >prn
  112.  
  113.     Print only pages 123 through 127, assuming that 106 pages are contained
  114.     in the first section of the list:
  115.  
  116.         C> intprint -n106 -r123:127 <interrup.b >prn
  117.  
  118. ------------------------------------------------------------------------------
  119.  
  120. PORTABILITY:
  121. ------------
  122.  
  123. INTPRINT.C contains the source code for INTPRINT, for those people who are
  124. using the interrupt list on a machine which does not run MSDOS.  This code has
  125. been tested with Turbo C and Mach (BSD 4.3 Unix) "cc".
  126.  
  127.